三方数据空间检索接口 最后更新时间: 2021年10月20日
产品介绍
三方数据空间检索接口是一类Web API接口服务，针对用户在GeoHUB数据中心上传的数据，以HTTP/HTTPS形式封装多种数据搜索接口，其中包括关键字搜索、周边搜索、多边形搜索、属性筛选四种筛选机制。以下为调用该接口前的数据准备流程：
- 使用API前您需先 申请Key ，若无高德地图API账号需要先申请账号。
- 前往 GeoHUB数据中心 创建您的数据集，并且保存上线，获取数据集ID。
适用场景
用户自行维护的点位/区块/轨迹等数据上传GeoHUB数据中心后，需要进行相关的空间/属性检索，以在前端实现灵活调用。
- 关键字搜索：通过数据属性中的关键字进行条件搜索，例如：肯德基、朝阳公园等。支持模糊搜索；
- 周边搜索：在用户传入经纬度坐标点附近，在设定的范围内，按照属性条件进行搜索；
- 多边形搜索：在多边形区域内进行搜索，按照属性条件进行搜索；
- 属性筛选：按照属性条件进行搜索。
使用限制
目前三方数据空间检索接口仅对企业开发者开放。
使用说明
第一步，申请”Web服务API”密钥（Key）；
第二步，拼接HTTP请求URL，第一步申请的Key需作为必填参数一同发送；
第三步，接收HTTP请求返回的数据（JSON或XML格式），解析数据。
如无特殊声明，接口的输入参数和输出数据编码全部统一为UTF-8。
服务文档
请求参数
1. 关键字搜索
请求示例：
https://restapi.amap.com/rest/lbs/geohub/place/text?key=<用户的key>&dataset_id=<id1>&condition_type=0&keywords=<keyword1>|<keyword2>
|
参数名
|
含义
|
规则说明
|
是否必须
|
缺省值
|
|
key
|
请求服务权限标识
|
用户在高德地图官网申请Web服务API类型Key
|
必填
|
无
|
|
dataset_id
|
数据集ID
|
暂时仅支持单个数据集
|
必填
|
无
|
|
properties_field
|
属性字段
|
选择关键字所在的属性字段
例如：[属性1]｜[属性2]｜[属性3]
|
可选
|
所有属性字段
|
|
condition_type
|
条件类型
|
0: 包含
1：等于
|
可选
|
1: 等于
|
|
keywords
|
关键字
|
[string1]|[string2]|[string3]
所有字段类型均parse成string
|
必填
|
无
|
|
offset
|
每页记录数据
|
整型, 强烈建议不超过25，若超过25可能造成访问报错
|
可选
|
20
|
|
page
|
当前页数
|
整型
|
可选
|
1
|
|
sig
|
数字签名
|
数字签名获取和使用方法
|
可选
|
无
|
|
output
|
返回数据格式类型
|
可选值：JSON，XML
|
可选
|
JSON
|
|
callback
|
回调函数
|
callback值是用户定义的函数名称，此参数只在output=JSON时有效
|
可选
|
无
|
2. 多边形搜索
请求示例：
https://restapi.amap.com/rest/lbs/geohub/place/polygon?key=<用户的key>&dataset_id=<id1>|<id2>&polygon=<coord1>|<coord2>
|
参数名
|
含义
|
规则说明
|
是否必须
|
缺省值
|
|
key
|
请求服务权限标识
|
用户在高德地图官网申请Web服务API类型Key
|
必填
|
无
|
|
dataset_id
|
数据集ID
|
暂时仅支持单个数据集
|
必填
|
无
|
|
polygon
|
多边形区域
|
多个坐标对集合，坐标对用”|”分割。多边形为矩形时，可传入左上右下两顶点坐标对；其他情况下首尾坐标对需相同。
|
必填
|
无
|
|
properties
|
筛选条件
|
各属性类型支持的操作, JSON数据, 示例:
{
“relation”: “and”, // 各个属性间的或与操作, 可选and,&&,or,||
“conditions”: [{
“field”: “alias”, // 属性名
“operation”: “like”, // 逻辑操作, 可选equal,=,not_equal,<>,greater,>,greater_equal,>=,less,<,less_equal,<=,in,like_any,like,not_like
“value”: “别名” // 属性值
}]
}
两层逻辑（age字段>1且<10）示例：
{
“relation”: “and”,
“conditions”: [{
“field”: “age”,
“relation”: “and”,
“conditions”:[{
“operation”: “>”,
“value”: 1
},{
“operation”: “<“,
“value”: 10
}]
}]
}
|
可选
|
无
|
|
offset
|
每页记录数据
|
整型, 强烈建议不超过25，若超过25可能造成访问报错
|
可选
|
20
|
|
page
|
当前页数
|
整型
|
可选
|
1
|
|
sig
|
数字签名
|
数字签名获取和使用方法
|
可选
|
无
|
|
output
|
返回数据格式类型
|
可选值：JSON，XML
|
可选
|
JSON
|
|
callback
|
回调函数
|
callback值是用户定义的函数名称，此参数只在output=JSON时有效
|
可选
|
无
|
3. 周边搜索
请求示例：
https://restapi.amap.com/rest/lbs/geohub/place/around?key=<用户的key>&dataset_id=<id1>&location=<coord1>&radius=<num>
|
参数名
|
含义
|
规则说明
|
是否必须
|
缺省值
|
|
key
|
请求服务权限标识
|
用户在高德地图官网申请Web服务API类型Key
|
必填
|
无
|
|
dataset_id
|
数据集ID
|
暂时仅支持单个数据集
|
必填
|
无
|
|
location
|
中心点位置
|
中心点经纬度坐标, 如: 120.165904,35.982862
|
必填
|
无
|
|
radius
|
半径
|
以中心点为圆心的距离半径（单位：m）
取值范围：(0,50000]
|
必填
|
无
|
|
properties
|
筛选条件
|
各属性类型支持的操作, JSON数据, 示例:
{
“relation”: “and”, // 各个属性间的或与操作, 可选and,&&,or,||
“conditions”: [{
“field”: “alias”, // 属性名
“operation”: “like”, // 逻辑操作, 可选equal,=,not_equal,<>,greater,>,greater_equal,>=,less,<,less_equal,<=,in,like_any,like,not_like
“value”: “别名” // 属性值
}]
}
两层逻辑（age字段>1且<10）示例：
{
“relation”: “and”,
“conditions”: [{
“field”: “age”,
“relation”: “and”,
“conditions”:[{
“operation”: “>”,
“value”: 1
},{
“operation”: “<“,
“value”: 10
}]
}]
}
|
可选
|
无
|
|
offset
|
每页记录数据
|
整型, 强烈建议不超过25，若超过25可能造成访问报错
|
可选
|
20
|
|
page
|
当前页数
|
整型
|
可选
|
1
|
|
sig
|
数字签名
|
数字签名获取和使用方法
|
可选
|
无
|
|
output
|
返回数据格式类型
|
可选值：JSON，XML
|
可选
|
JSON
|
|
callback
|
回调函数
|
callback值是用户定义的函数名称，此参数只在output=JSON时有效
|
可选
|
无
|
4. 属性筛选
请求示例：
https://restapi.amap.com/rest/lbs/geohub/place/properties?key=<用户的key>&dataset_id=<id1>|<id2>
|
参数名
|
含义
|
规则说明
|
是否必须
|
缺省值
|
|
key
|
请求服务权限标识
|
用户在高德地图官网申请Web服务API类型Key
|
必填
|
无
|
|
dataset_id
|
数据集ID
|
暂时仅支持单个数据集
|
必填
|
无
|
|
properties
|
筛选条件
|
各属性类型支持的操作, JSON数据, 示例:
{
“relation”: “and”, // 各个属性间的或与操作, 可选and,&&,or,||
“conditions”: [{
“field”: “alias”, // 属性名
“operation”: “like”, // 逻辑操作, 可选equal,=,not_equal,<>,greater,>,greater_equal,>=,less,<,less_equal,<=,in,like_any,like,not_like
“value”: “别名” // 属性值
}]
}
两层逻辑（age字段>1且<10）示例：
{
“relation”: “and”,
“conditions”: [{
“field”: “age”,
“relation”: “and”,
“conditions”:[{
“operation”: “>”,
“value”: 1
},{
“operation”: “<“,
“value”: 10
}]
}]
}
|
必填
|
无
|
|
offset
|
每页记录数据
|
整型, 强烈建议不超过25，若超过25可能造成访问报错
|
可选
|
20
|
|
page
|
当前页数
|
整型
|
可选
|
1
|
|
sig
|
数字签名
|
数字签名获取和使用方法
|
可选
|
无
|
|
output
|
返回数据格式类型
|
可选值：JSON，XML
|
可选
|
JSON
|
|
callback
|
回调函数
|
callback值是用户定义的函数名称，此参数只在output=JSON时有效
|
可选
|
无
|
返回结果（通用）
|
名称
|
类型
|
说明
|
|
status
|
string
|
本次API访问状态，如果成功返回1，如果失败返回0。
|
|
info
|
string
|
访问状态值的说明，如果成功返回”ok”，失败返回错误原因，具体见错误码说明。
|
|
infocode
|
string
|
返回状态说明,10000代表正确,详情参阅info状态表
|
|
count
|
string
|
单次请求返回的实际poi点的个数
|
|
objects
|
object
|
符合关键字筛选条件的数据对象
|
|
|
geometry
|
coordinates
|
string，array
|
点对象（string）：’39.23489, 127.32487′
线/面对象（array）：
[‘39.23489, 127.32487’, ‘39.23489,
127.32487′, ‘39.23489, 127.32487’,
‘39.23489, 127.32487’, ‘39.23489,
127.32487′, ‘39.23489, 127.32487’]
|
|
type
|
string
|
point/polyline/polygon/multipoint/multipolyline/multipolygon
|
|
|
properties
|
property1
|
name
|
string
|
属性名称
|
|
value
|
string/number/boolean
|
属性值
|
|
property2
|
name
|
string
|
属性名称
|
|
value
|
string/number/boolean
|
属性值
|
|
…
|
…
|
…
|
…
|
